5.3.3 APPX Application Design Manual

+ Chapter 1-1: Overview of Application Design
+ Chapter 1-2: Getting Started
+ Chapter 1-3: Data Dictionary
+ Chapter 1-4: Understanding Process Design
+ Chapter 1-5: Interprocess Communication
+ Chapter 1-6: Customizing Your Application
+ Chapter 1-7: The Documentation Facility
+ Chapter 1-8: Application Design Tools
+ Chapter 2-1: Data Dictionary Overview
+ Chapter 2-2: Data Dictionary Concepts
+ Chapter 2-3: Domains
+ Chapter 2-4: Files and Fields
- Chapter 2-5: Work Fields
+ Chapter 3-1: Overview of APPX Processes
+ Chapter 3-2: Getting Started
+ Chapter 3-3: Process Definition
+ Chapter 3-4: Menu Processes
+ Chapter 3-5: Job Processes
+ Chapter 3-6: Input Processes
+ Chapter 3-7: Output Processes
+ Chapter 3-8: Update Processes
+ Chapter 3-9: Query Processes
+ Chapter 3-10: Inquiry Processes
+ Chapter 3-11: Status Processes
+ Chapter 3-12: Subroutine Processes
+ Chapter 3-13: Table Processes
+ Chapter 3-14: Automatic and Optional Children
+ Chapter 3-15: Using the Image Editor
+ Chapter 3-16: Using GUI Features of the Image Editor
+ Chapter 3-17: Using Event Points
+ Chapter 4-1: ILF Integration
+ Chapter 4-2: True/False Status Indicators
+ Chapter 4-3: Specifying Statements
+ Chapter 4-4: The ILF Editor
+ Chapter 4-5: The Appx ILF Debugger
+ Chapter 4-6: ILF Keyword Reference
+ Chapter 4-7: Predefined Fields
+ Chapter 4-8: Runtime Subroutine's and Predefined Processes
+ Chapter 4-9: Appx Chart Director API

Chapter 2-5: Work Fields

Numeric Work Fields


A numeric work field is restricted to number, decimal, and sign (-) entries. Examples include amounts, prices, and quantities.

The Numeric work fields overlay, shown below, permits you to add numeric-specific attributes to those already defined for the work field. It automatically displays after you complete the entries on the Work fields specifications screen if the Field Type youselect is NUMERIC.

Numeric Work Fields Overlay

The Numeric work fields overlay contains the following fields:

Digits Left. Enter the number of digits to the left of the decimal.

Digits Right. Enter the number of digits to the right of the decimal.

Signed? specifies whether the numbers entered in this field are positive or negative. A 'no' would ensure that only positive numbers are entered. The default is 'no'.

Descriptive provides a longer, more easily understood alternative to Field Name, one that is not required to be unique within an application. If blank at all default levels, Field Name is used.

Column Hdgs designates up to two lines of column heading text. The APPX output process facility uses this text to generate standard column heading images for Start of Page and Start of Range class frames. For cosmetic reasons, the length of headings should not exceed the length of a field itself. Refer to Standard Column Heading Image for additional information.

Auto Seq? Select 'yes' if this numeric field represents a sequence number with a value that should be maintained by APPX. Click the checkbox to toggle between 'yes' and 'no' . Note that Auto Seq? only appears if the numeric field has no decimal places.

From the Numeric work fields overlay, you can select the Additional Attributes overlay, shown below.

Numeric Work Fields Additional Attributes Overlay

The numeric work fields Additional Attributes overlay contains the following fields:

Dflt Display Msk designates the format that the data displays to a user in an APPX image. This entry establishes the Display Mask default for all image items that reference the numeric field. If blank, APPX uses a display of nonfixed leading spaces with one significant digit. Refer to Numeric Domains for additional information about this entry.

Default Value establishes a starting value for all image items whenever they first display in add mode in an input image, unless modified by a user. If blank, the starting value is assumed to be the null value.

Range Checks defines a series of allowable values that APPX uses for online data validation. The first component represents the relation. The options are EQ (equal to), NE (not equal to), GT (greater than), LT (less than), GE (greater than or equal to), and LE (less than or equal to). The second component represents the value that is assigned to the relation. If you enter two relations, APPX infers an AND relationship.

Occurrence determines the number of times a field is present in a record. If blank, APPX assumes a value of 1. This field may contain up to five numeric characters and is restricted to a maximum of 32,767. See the Occurrence section for a more comprehensive discussion of this field.

Storage Type determines the internal storage format for data. The Storage Type options are:

BINARY  The number is stored in binary form. The high order bit determines the sign: on or 1 for positive, and off or 0 for negative. The decimal position is established by the Decimals Left/Right entries. The maximum field length is 10 digits for non-decimal numbers or 9 digits for decimal numbers.

FIXED DECIMAL employs a packed decimal format that stores two decimal digits for each byte with the exception of the last bit, which is the sign bit. The decimal position is established by the Decimals Left/Right entries. The maximum field length is 31 digits.

FLOATING DECIMAL employs a combination of binary and packed decimal formats that always requires a total of nine bytes of storage. Although the field definition allows for 15 digits to the left of the decimal point plus 15 digits to the right of the decimal point, only the first 15 digits of the actual number are stored. These 15 digits are stored as packed decimal with two decimal digits for each byte (for a total storage requirement of eight bytes). The final byte (binary) determines the maximum number of digits that currently appears to the right of the decimal.

The default is FIXED DECIMAL. For a comprehensive discussion of these options, see Numeric Storage Types.

Share Class defines at what level the values contained in this work field can be shared. The Share Class options are:

SUBPROCESS  The values can be shared between a process and its subprocesses.

RELATED  The values can be shared among related processes in a job.

DETACHED  The values are available until the user logs off.

NOT SHARED  The values are available only for the current process.

The default is SUBPROCESS.

Application Design Manual                                         "Powered by Appx Software"

1058

©2006 By APPX Software, Inc. All Rights Reserved